Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

ShowMoviePoster

You can use the ShowMoviePoster function to display a movie's poster. The movie poster uses the movie's matrix and display clipping characteristics.

pascal void ShowMoviePoster (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The Movie Toolbox draws the movie poster once, in the movie's graphics world. This function works on active and inactive movies.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can set the poster's starting time with the SetMoviePosterTime function (described on page 2-105). You can set the position and size of the poster by calling the SetPosterBox function (described in the next section).